
 WinLIB PRO Demo
 Version 0.63A dated 03/05/94

 By Ken Hollis and Karl Anders ²ygard
 Released by Bitgate Software (USA) and Clever Bits (Norway)

 This is uncompleted documentation.  If you want to fool around with the
 source code, more power to 'ya.  I will not explain any routines that are
 undocumented.  You must find them out for yourself.  Hey, it was FREE!

 (Check out the TEST.C file.  It tells you quite a lot about how to code
  with the library.)

 -------------------------------------------------------------------------

 This demo may be freely copied and distributed as long as there is no fee
 involved with such distribution.  This program is Public Domain, and must
 be released as-is, with no modifications done to any part of the archive
 or the program itself.

 -------------------------------------------------------------------------

 NOTICE TO BETATESTERS:
 """"""""""""""""""""""
 This is the newest release for you guys, and there are quite a number of
 improvements to the library.  For one thing, we have added desktop rout-
 ines (and have worked on them a bit), boxframes with new 3D colour
 design (thanks to an idea by Dan Hollis, a friendly betatester), command
 lines (like those in Windoze), Menu command separators (like those found
 in Geneva, and Enhanced GEM), and menubars with side roots (which work
 quite well).

 Although this version is slow for the text part of things, I have decided
 to go ahead and release this version so you can see what I've done, and
 how the program itself is coming along.  Since this is not an official
 release of the demo program itself, please report any bug reports.  If
 you see a bug report that is *NOT* in the incompatibilities section,
 please report it, otherwise, don't.  I already know about it.

 -------------------------------------------------------------------------

 New additions to WinLIB PRO:
 """"""""""""""""""""""""""""
 Since WinLIB PRO was last released, it has grown in popularity.  There-
 fore, we have decided to continue its growth to gain more interest.

 The following is a detailed list of the features that have been added
 since its previous 0.62 release:

 o Desktop routines:  Now WinLIB PRO allows you to iconify windows, delete
   them, use the clipboard, and remove icons all in an easy-to-use desktop
   style environment.

 o Boxframes:  You may have noticed that alot of items could be boxed into
   nice little categories of selections.  The previous version did not
   have this look; it required two objects (a header and a box) to perform
   this task.  It now requires only one item, and can be modified at ease.

 o Command lines:  You may have used Windows in the past.  If you have,
   you can plainly see that at the bottom of the window in some programs,
   there is a long line that displays information about an object that you
   click on, or about a menu item that you click.  This is now a part of
   WinLIB PRO's library.

 o Custom menu separators:  Now, WinLIB PRO allows you to create custom
   menu separators inside menus.  This is a long bar (disabled, of course)
   and is used to make the menus look nicer.

 o Menu bars with side roots:  Now you can design a menu bar like never
   before with new customized side root menus!  These add a nice little
   feature, giving you a longer menu under one SUBTOPIC.  All you have
   to do is set the Extended Object Type to point to your popup dialog,
   and viola!  It's easier to check than it looks!  Also includes special
   utilities based on MultiTOS (menu_attach/detach)

 o New flying dialogs, thanks to Markus Gutschke.  Now, you can move
   any dialog box (MODAL only) around the screen by clicking on its flying
   dialog object.  Then, you can just move the dialog as you normally do,
   and it redraws the dialog AS YOU MOVE IT.  Nice addition.

 -------------------------------------------------------------------------

 Using WinLIB PRO:

 When you first booted this program, you will notice the menu bar at the
 top of the screen.

 Use your mouse, and go up to the "Desk" menu.  Select "About WinLIB PRO".
 You will then see a nice little windowed dialog box that lets you see the
 information about this demo.

 Hotkeys are accessable in this demo by using the ALT-key and the high-
 lighted key.  If there is a dialog box without an editable object inside
 it, you can simply press the key that is highlighted to access that
 object.

 Next, use your mouse and go to the "Windows" menu.  Select "Window #1".
 This is a timer window, and it demonstrates the usage of WinLIB PRO's
 multitasking timer windows.

 Select "Dialog #1" and you will see the first dialog box for the demo.
 This demonstrates the usage of selectable boxes (with "X"es), circle-
 cell radio buttons, editable text fields in which the mouse can re-
 position the cursor, and the boxframes.  Select "OK" to close this
 window.

 Select "Dialog #2" and you will be presented with another example.  This
 example shows the different 3D drawing methods of WinLIB PRO.  These are
 identical to MultiTOS/GEM 4.04.

 Select "Dialog #3" and you will be able to select a dropdown menu bar
 inside the dialog.  Select either the down arrow (Dropdown arrow) or
 the "Popup menu" items inside the dialog box.  You will then see a nicely
 assorted selection of popup menus.

 Select "Dialog #4" and you can use the redraw-as-you-drag sliders.  Also,
 the two rows of four boxes at the bottom are for testing purposes, and do
 not currently have any function.  They just show the drawing styles that
 we have, and rooted objects.  Actually, this is for a sizing problem
 we are trying to fix at the moment.

 -------------------------------------------------------------------------

 Incompatibilities as of this time:
 """"""""""""""""""""""""""""""""""
 As with any program that doesn't still have all of the bugs out, there
 will be some incompatibilities.  These are, of course, being worked on,
 and should be rid of by the next version:

 The MENU BAR doesn't work with MultiTOS at the moment.  This is because
 WinLIB PRO uses a special menu routine to handle the side-rooted objects
 for the menu bar.  This should be fixed in the next version, if not
 sooner.  It will be placed in a window if we can't get this thing working
 correctly to fit MultiTOS's specifications...  Sheez!

 We know the desktop doesn't work that great.  We are currently working
 on fixing the problem.  The ghost rectangle leaves a hideous mark after
 you select an icon with it drawn.  We are working on correcting the
 problem at this time with Olaf Meisiek.

 Don't tell us how slow the text window routines are.  We'll just jump up
 and down and have a fit on the spot and never forgive you.

 We know help files don't work smoothly.  Don't remind us.  We're working
 with Dan Wilga to get the format for his help files so we can create our
 own help file viewer, hopefully with icons, custom selection buttons
 (with a slight appearance to that of GEM, but less sophisticated), and
 full-color bitmaps inside the display, as well as size changing.  All of
 this will be released at a later date.

 Report any incompatibilities to KEN HOLLIS and KEN HOLLIS ONLY, since he
 is the main programmer.  I am not responsable for any damage that this
 program does to your system, but since it does not save any data to your
 hard drive or floppy disk drives, don't panic.  It should not harm any
 running processes or manipulate any protected data.

 The menu bars are totally and completely incompatible with MultiTOS and
 Geneva at the moment.  Remedies are being designed.

 -------------------------------------------------------------------------

 Bug fixes:
 """"""""""
 Menu bars have been fixed so that they now are almost bug free.  Instead
 of using the AES Screen Buffer of the Window Manager, we reserve our own
 memory on the side to do screen copies, making things much safer.

 We can now register desk accessory names, but they cannot be called yet.

 No more bugs should result from using the menu bars.

 Unfortunately, we still haven't been able to figure out how to CORRECTLY
 call accessories.  I have made attempts (with The Accessor) and have hit
 brick walls from not being able to get it right.  Apparently, GEM has a
 mind of its own in loading accessories.  I still don't know if they do it
 by loading in the first accessory file they see (in unsorted order) or if
 they use a special technique.  I just don't understand it (yet).

 Since the menu bars won't let you access accessories the complex way, we
 opted to have an internal menu that will let you select an accessory by
 using the standard menu_bar, and not ours (yet).

 -------------------------------------------------------------------------

 Keyboard Equivalents:

 At any time, hit [CTRL-ALT] and the following keys for quick, and easy
 equivalents:

 (BS - Backspace)
 (SP - Space)
 (KP - Keypad and key shown)

 Key:   Action:
 """""  """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 <BS>   Close all currently opened windows (except iconified windows)
 <SP>   Redraw all currently opened windows
 <KP*>  Iconify/Maximize the current window
 <KP8>  Move text inside a window up (try it now!)
 <KP2>  Move text inside a window down
 ENTER  Redraw the current window
 UP     Move text inside a window up
 DOWN   Move text inside a window down
 HELP   Call the hyper-text help screen (currently unavailable)
 <ESC>  Close the current window

 (These are the 3D styles:)
 F5     MultiTOS/GEM 4.04 look
 F6     Olaf Meisiek's (Zoom! Color Icon Editor) 3D look
 F7     Motif (X11R5) 3D look
 F8     Dan Wilga's (Geneva) 3D look
 F9     WinLIB PRO 3D look (currently unavailable, it's being designed!)
 F10    No 3D (Standard, wimpy NON-3D look (standard to AES below 3.0))

 -------------------------------------------------------------------------

 Coming Later (MUCH later):

 o Color icons inside the desktop and dialog boxes
 o WinLIB PRO 3D look
 o Full Mag!x compatibility (if I can ever get my hands on Mag!x)
 o Internal IGORView (our new help file viewer) for hyper-text files
 o anything else we can think of!

 -------------------------------------------------------------------------

 Special thanks to:
 """"""""""""""""""
 - Christian Rountree for moral support on the ForemNET
 - Peter Seitz for his great Application Library (APP_LIB)
 - Olaf Meisiek for support, programming help, and some debugging
 - Markus Gutschke for his flying dialog and screen copy routines, and
   his object-oriented library
 - Dan Wilga for helpful hints and tips here and there and for the help
   with Pure C and Geneva programming tips
 - Christian Grunenberg for letting me use various parts of Enhanced GEM
   for reference (I still think WinLIB PRO is better, though, Criss!  ^_^)
 - Eric Smith for the info on appl_search (for desk accessory stuff for
   MultiTOS), and on other special routines used internally, especially
   for tips on programming with MultiTOS
 - Dan Hollis, Andy Smith, Christian Rountree, Michael Forget, and
   Michael Robinson for timeless betatesting on their Atari STs and other
   platforms by Atari...  You all made it possible!
 - MEGA thanks to Dan Hollis for helping me figure out how to get the
   desk accessory names.  Without him, the desk accessory calling would
   never have been possible.

 -------------------------------------------------------------------------

 Any questions about this demo program, or any like it that we release?
 If so, please contact us at:

 Ken Hollis
   InterNET:  khollis@bitsink.gbdata.com

 Karl ²ygard
   InterNET:  karlo@ifi.uio.no

 If you are interested in become a betatester, or are reporting a bug,
 please write to one of us, preferrably Ken Hollis.  Also, if you are
 interested in joining the programming project, please write to Ken Hollis.

 Happy coding...
 Ken Hollis and Karl ²ygard
